home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cato / Xm / MrmFetchColorLiteral.z / MrmFetchColorLiteral
Text File  |  1998-10-20  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMrrrrmmmmFFFFeeeettttcccchhhhCCCCoooolllloooorrrrLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  MMMMrrrrmmmmFFFFeeeettttcccchhhhCCCCoooolllloooorrrrLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           MMMMrrrrmmmmFFFFeeeettttcccchhhhCCCCoooolllloooorrrrLLLLiiiitttteeeerrrraaaallll - Fetches a named color literal from a
  10.           UID file
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<MMMMrrrrmmmm////MMMMrrrrmmmmPPPPuuuubbbblllliiiicccc....hhhh>>>>
  14.  
  15.           iiiinnnntttt MMMMrrrrmmmmFFFFeeeettttcccchhhhCCCCoooolllloooorrrrLLLLiiiitttteeeerrrraaaallll((((_h_i_e_r_a_r_c_h_y__i_d, _i_n_d_e_x, _d_i_s_p_l_a_y, _c_o_l_o_r_m_a_p__i_d, _p_i_x_e_l))))
  16.                MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy_h_i_e_r_a_r_c_h_y__i_d;;;;
  17.                SSSSttttrrrriiiinnnngggg    _i_n_d_e_x;;;;
  18.                DDDDiiiissssppppllllaaaayyyy   ****_d_i_s_p_l_a_y;;;;
  19.                CCCCoooolllloooorrrrmmmmaaaapppp  _c_o_l_o_r_m_a_p__i_d;;;;
  20.                PPPPiiiixxxxeeeellll     ****_p_i_x_e_l;;;;
  21.  
  22.  
  23.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  24.           This page documents version 1.2 of the Motif library.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           The MMMMrrrrmmmmFFFFeeeettttcccchhhhCCCCoooolllloooorrrrLLLLiiiitttteeeerrrraaaallll function fetches a named color
  28.           literal from a UID file, and converts the color literal to a
  29.           pixel color value.
  30.  
  31.  
  32.           _h_i_e_r_a_r_c_h_y__i_dSpecifies the ID of the UID hierarchy that
  33.                       contains the specified literal.  The
  34.                       _h_i_e_r_a_r_c_h_y__i_d was returned in a previous call to
  35.                       MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
  36.  
  37.           _i_n_d_e_x       Specifies the UIL name of the color literal to
  38.                       fetch.  You must define this name in UIL as an
  39.                       exported value.
  40.  
  41.           _d_i_s_p_l_a_y     Specifies the display used for the pixmap.  The
  42.                       _d_i_s_p_l_a_y argument specifies the connection to the
  43.                       X server.  For more information on the DDDDiiiissssppppllllaaaayyyy
  44.                       structure, see the Xlib function XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy.
  45.  
  46.           _c_o_l_o_r_m_a_p__i_d Specifies the ID of the color map.  If NULL, the
  47.                       default color map is used.
  48.  
  49.           _p_i_x_e_l       Returns the ID of the color literal.
  50.  
  51.  
  52.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  53.           This function returns one of these status return constants:
  54.  
  55.  
  56.           MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS       The function executed successfully.
  57.  
  58.           MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY The hierarchy ID was invalid.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMrrrrmmmmFFFFeeeettttcccchhhhCCCCoooolllloooorrrrLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  MMMMrrrrmmmmFFFFeeeettttcccchhhhCCCCoooolllloooorrrrLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           MMMMrrrrmmmmNNNNOOOOTTTT____FFFFOOOOUUUUNNNNDDDD     The color literal was not found in the UIL
  75.                            file.
  76.  
  77.           MMMMrrrrmmmmWWWWRRRROOOONNNNGGGG____TTTTYYYYPPPPEEEE    The caller tried to fetch a literal of a
  78.                            type not supported by this function.
  79.  
  80.           MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE       The function failed.
  81.  
  82.  
  83.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  84.           MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))), MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy((((3333XXXX)))),
  85.           MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))), MMMMrrrrmmmmFFFFeeeettttcccchhhhLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))), and
  86.           XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy((((3333XXXX)))).
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.